Skip to content

Conversation

@craig-osterhout
Copy link
Contributor

@craig-osterhout craig-osterhout commented Jul 12, 2025

Description

Groups: https://deploy-preview-23078--docsdocker.netlify.app/manuals/
Example drilldown: https://deploy-preview-23078--docsdocker.netlify.app/docker-hub/

A quick POC to explore how drilldown and multi-group manuals feel.

Multi-group assignment lets us not have to try to find non-overlappig groups.
Drilldown reduces the overwhelming left nav and enables multi-groups.

Used javascript since it was quicker to poc, but we already have a similar static implementation for tags/samples we can reuse if this direction looks good.

Didn't make any effort on styling. But imagine flashy cards instead of simple list. Also, dark mode doesn't work in this poc.

Inspired by the product category component at https://docs.aws.amazon.com/

Added a fake "Desktop" group to demonstrate cross-group membership.

Related issues or tickets

Reviews

Signed-off-by: Craig <[email protected]>

landing page and nav

Signed-off-by: Craig <[email protected]>
@netlify
Copy link

netlify bot commented Jul 12, 2025

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 048d742
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6871b7c9612a9800080aacb6
😎 Deploy Preview https://deploy-preview-23078--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added area/desktop Issue affects a desktop edition of Docker. E.g docker for mac hugo Updates related to hugo area/ai labels Jul 12, 2025
@craig-osterhout
Copy link
Contributor Author

craig-osterhout commented Jul 14, 2025

Single page manuals don't drill down correctly. No left nav is generated.
image
Although, if using a folder with just a single index page, the menu generates but has a useless dropdown because there are no child topics. This is actually a bug in our current implementation too.

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/ai area/desktop Issue affects a desktop edition of Docker. E.g docker for mac hugo Updates related to hugo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant